CreateFacetIterator

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODFrame

CreateFacetIterator
The CreateFacetIterator method creates a frame-facet iterator object for the facets of this frame.
ODFrameFacetIterator CreateFacetIterator ();
return value
A reference to a new frame-facet iterator object.

DISCUSSION
Your part calls this method if it needs to apply an operation to all facets of one of your display frames, such as drawing and changing their shapes. It is your responsibility to delete the iterator when it is no longer needed.
While you are using a frame-facet iterator, you should not modify the list of facets for the frame. You must postpone adding items to or removing items from the list of facets for the frame until after you have deleted the iterator.

SEE ALSO
The ODFacet::CreateFacetIterator method (page 239).
The ODFrameFacetIterator class (page 342).
"Asynchronous Drawing" on page 166 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.